Programming With QuickTime VR 2.1

Previous | Overview | Contents | Next

Initializing and Managing QuickTime VR Movie Instances

The QuickTime VR Manager provides routines for obtaining a QTVR track and a new movie instance.

QTVRGetQTVRTrack

You can use the QTVRGetQTVRTrack function to get a QTVR track contained in a QuickTime movie.

Track QTVRGetQTVRTrack (Movie theMovie, SInt32 index);
theMovie
A QuickTime movie.
index
The index of the desired QTVR track.
function result
A track identifier for the QTVR track having the specified index in the specified QuickTime movie.

DESCRIPTION

The QTVRGetQTVRTrack function returns, as its function result, a track identifier for the QTVR track that has the index specified by the index parameter in the QuickTime movie specified by the theMovie parameter. If there is no such track, QTVRGetQTVRTrack returns the value nil .

SPECIAL CONSIDERATIONS

The index parameter is valid only for QuickTime VR movies that conform to version 2.0 or later of the QuickTime VR file format. Earlier versions of the file format permit only one QTVR track per file; QTVRGetQTVRTrack returns that track.

SEE ALSO

Use QTVRGetQTVRInstance (next) to get a QuickTime VR movie instance from the track identifier returned by QTVRGetQTVRTrack .

QTVRGetQTVRInstance

You can use the QTVRGetQTVRInstance function to get an instance of a QuickTime VR movie.

OSErr QTVRGetQTVRInstance (
                     QTVRInstance *qtvr,
                     Track qtvrTrack,
                     MovieControllermc);
qtvr
On exit, an instance of the specified QuickTime VR movie.
qtvrTrack
A QTVR track contained in a QuickTime movie. You can obtain a reference to this track by calling QTVRGetQTVRTrack (described in the section "QTVRGetQTVRTrack" ).
mc
An identifier for the movie controller to be associated with the new QuickTime VR movie instance. You can get a movie controller identifier by calling the NewMovieController function.
function result
A result code.

DESCRIPTION

The QTVRGetQTVRInstance function returns, in the qtvr parameter, an instance of the QuickTime VR movie specified by the qtvrTrack parameter. If qtvrTrack does not specify a QTVR track, QTVRGetQTVRInstance returns nil in the qtvr parameter and an error code as its function result. You need a QuickTime VR movie instance to call most other QuickTime VR functions.

SPECIAL CONSIDERATIONS

It's not necessary to dispose of a QuickTime VR movie instance.

© 1997 Apple Computer, Inc.

Previous | Overview | Contents | Next